System_read-Baustein

Kurz-Information

Name	`System_read`
→POE-Typ	→Funktion
Kategorie	Weitere Systembausteine, Bausteine zum Aufrufen von Systemfunktionen, Baustein mit interner Fehlerdiagnose
Grafische Schnittstelle
Verfügbar ab	Version 1.13.0 (für Neuron Power Engineer) und Version 2.3.901 des →Laufzeitsystems – Anfangsvariante: `data` als `VAR_INPUT` Dieser Baustein wird nur für →Raspberry Pi unterstützt. Version 1.54.0 (für Neuron Power Engineer) und Version 3.0.9 des →Laufzeitsystems – Erweiterung: zusätzlicher Ausgang `rc`, `data` als `VAR_IN_OUT` Dieser Baustein wird nur für die integrierte SPS und Raspberry unterstützt. Version 1.109.0 (für Neuron Power Engineer) und Version 3.19.0 des →Laufzeitsystems Dieser Baustein wird nur für die integrierte SPS, für Raspberry Pi und bei Verwendung der Plattform `LinuxX86` unterstützt. Version 2.0.4 (für Bibliothek `System`) und Version 3.23.0 des →Laufzeitsystems Dieser Baustein wird nur für die integrierte SPS und bei Verwendung der Plattform `LinuxX86` unterstützt. Zusätzlich wird der Baustein für die folgenden Zielsysteme unterstützt: Raspberry Pi, →phyBOARD-Regor, →phyBOARD-Wega, →µMIC.200 Version 2.0.5 (für Bibliothek `Standard`) – grafische Schnittstelle mit Ein-/Ausgangsvariable

Funktionalität

Der Baustein liest bis zu 64 Bytes von einem definierten Datei-Deskriptor.

Vorausgesetzte Kenntnisse

Für die effektive Verwendung dieses Bausteins müssen Sie mit der Funktionsweise des zugrunde liegenden Systemaufrufs des Betriebsystems vertraut sein, das auf der SPS verwendet wird.

Eingänge, Ausgänge, Ergebniswert

	Bezeichner	→Datentyp	Beschreibung
Eingänge:	`fd`	`DINT`	der Datei-Deskriptor
Eingänge:	`count`	`DINT`	Anzahl der Bytes, die in einem Zug gelesen werden sollen
Ein-/Ausgänge (VAR_IN_OUT):	`data`	`ARRAY[0..63] OF BYTE`	die zu schreibenden Bytes
Ausgänge:	`rc`	`DINT`	Ergebniscode: `0` = kein Fehler `-2` = ungültige Anzahl der Bytes `-3` = fehlgeschlagener Systemaufruf
Ausgänge:	`errno`	`DINT`	der Fehlercode, der vom Systemaufruf geliefert wird Windows-Standardwerte (für die integrierte SPS gültig): siehe https://msdn.microsoft.com/en-us/library/t3ayayh1.aspx Linux-Standardwerte(z.B. für Raspberry Pi gültig): siehe http://www-numi.fnal.gov/offline_software/srt_public_context/WebDocs/Errors/unix_system_errors.html
Ergebniswert:	–	`LINT`	liefert den Ergebniswert des Systemaufrufs zum Lesen

Der Eingang EN und der Ausgang ENO sind für den →Aufruf des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN und zum Ausgang ENO.

Informieren Sie sich unter:

"Bausteine für sichere Logik", ob dieser Baustein für das Entwickeln von sicherheitsrelevanten Anwendungen unterstützt wird.
"Kennzeichnung von sicherer Logik im FBS-Editor", welche Auswirkung die Verwendung des Bausteins als Baustein für sichere Logik hat.

Der Ausgang ENO für diesen Baustein liefert den Wert TRUE (oder eine Entsprechung) nur, sofern die definierte Anzahl an Bytes auch gelesen wurden.

Interne Fehlerdiagnose für Baustein

Der Baustein prüft die folgenden Fehlerfälle:

Der Systemdienst wurde nicht geladen.
Der Ergebniswert des Bausteins ist ein negativer Wert.
Der Ergebniscode des Funktionsaufrufs entspricht einem Fehler (Ausgang rc ≠ Wert 0).

In einem solchen Fehlerfall wird der Ausgang ENO des Bausteins auf den Wert FALSE (oder eine Entsprechung) zurückgesetzt.

Beispiel für Verwendung im ST-Editor

Derzeit ist kein Beispiel verfügbar.